home *** CD-ROM | disk | FTP | other *** search
/ Aminet 21 / Aminet 21 (1997)(GTI - Schatztruhe)[!][Oct 1997].iso / Aminet / util / boot / ClockChk13.readme < prev    next >
Encoding:
Text File  |  1997-09-05  |  5.7 KB  |  145 lines
  1. Short:    Keeps track of clock changes, V1.3
  2. Author:   christianw@on-line.de
  3. Uploader: christianw@on-line.de
  4. Type:     util/boot
  5. Replaces: util/boot/ClockChk12.lha
  6.  
  7. Introduction:
  8.  
  9. This program is extremely useful when you need proper clock settings
  10. on your computer.  It's extremely annoying if some buggy software
  11. trashes the clock settings and e.g.  the newsreader sets the date of
  12. incoming news to 2023 (which happened to the programmer some time ago...
  13. that was the reason for writing this program).
  14.  
  15. Function:
  16.  
  17. When the program is started, it first checks when the last session on
  18. your Amiga was.  If the date differs from the current date by more
  19. than a certain number of days (which can be set via an environment
  20. variable), you will be notified about that and you can let the program
  21. start the time preferences program.  After that the clock is checked
  22. each second.  If it changes by more than one minute, a requester pops
  23. up.  Note that programs that disable multitasking for more than one
  24. minute will dupe ClockChk into detecting a time change.  To avoid this
  25. behaviour, either don't use your system after playing such a game or
  26. invoke ClockChk with the CLI parameter "ONCE", so ClockChk will return
  27. after the doing initial clock check and setting the environment
  28. variable that contains the date of the last session.
  29.  
  30. The program can be ended by sending a CTRL-C signal to it, but that's
  31. normally not necessary because it uses very little memory and nearly
  32. no CPU time.
  33.  
  34. Installation:
  35.  
  36. Copy program to C: and enter the following line into s:user-startup
  37.  
  38. run <>nil: ClockChk
  39.  
  40. When ClockChk is started the very first time, the date of the last
  41. setting will obviously not be present and a requester will pop up that
  42. informs you about that.  Hit "Ignore" in this case.
  43.  
  44. Configuration:
  45.  
  46. ClockChk is configured by setting environment variables.  Don't forget
  47. to copy them to ENVARC: if you want to permanently set them.
  48.  
  49. DAYDIFF
  50.    Contains the number of days between two sessions without being
  51.    notified by setting the environment variable DAYDIFF.  The default
  52.    value is 3 which will be used when the variable isn't set up or if
  53.    it's invalid.
  54.  
  55. TIMEPREFS
  56.    Contains the full path of the Time Preferences editor.  If it isn't
  57.    set, SYS:Prefs/Time will be used.
  58.  
  59. LASTDATE
  60.    Contains the date and time of the last session.  You don't need to
  61.    bother about this variable.  If it's invalid or not present (the
  62.    latter will happen with the very first run of ClockChk), you will
  63.    be notified and after that the current date is saved to it.
  64.  
  65. Bugs:
  66.  
  67. None known.
  68.  
  69. Notes:
  70.  
  71. ClockChk has to write into ENVARC:  in order to save the current
  72. session's date.  If the write operation fails, you will be notified
  73. about that, of course.
  74.  
  75. Disclaimer:
  76.  
  77. The author cannot be held liable for the suitability or accuracy of
  78. this manual and/or the program(s) it describes.  Any damage directly
  79. or indirectly caused by the use or misuse of this manual and/or the
  80. program it describes is the sole responsibility of the user her/him
  81. self.
  82.  
  83. Copyright/Distribution
  84.  
  85. All files mentioned below are (C) Copyright 1997 Christian Wasner.
  86. All rights reserved.
  87.  
  88. These files/programs are FREEWARE, so no financial donations are
  89. required (but welcome).  They may be freely distributed as long as all
  90. files remain unchanged and are included with the distribution.
  91. Distribution on disks or CDs is permitted only on the disks or CDs
  92. from Fred Fish, the Aminet CDs, from disks that cost less than $1 or
  93. from CDs that cost less then $20.  Electronical distribution (e.g.  by
  94. Aminet, mailboxes, modems) is allowed.  Inclusion into freeware
  95. software packages is allowed, inclusion into other packages (e.g.
  96. commercial or shareware) must be expressly allowed by me in written
  97. form.
  98.  
  99. The following files should come along:
  100.  
  101. ClockChk             Executable program                     6039 bytes
  102. ClockChk13.readme    Documentation                          5306 bytes
  103. ClockChk.c           Source code                            7978 bytes
  104. SCOPTIONS            Options for compiling with SAS-C 6.58   205 bytes
  105. FILE_ID.DIZ          Mailbox description                     388 bytes
  106.  
  107.  
  108. History:
  109.  
  110.    05-Feb-97 V1.0   - Initial release
  111.  
  112.    12-Feb-97 V1.1   - Aminet version showed version 0.1 on "version"
  113.                       command.
  114.                     - File list contained wrong name of documentation.
  115.                     - Date of current session wasn't saved correctly
  116.                       when detecting a date discrepancy with the last
  117.                       session's date along with correcting the date.
  118.  
  119.    04-Aug-97 V1.2   - The program couldn't handle date string with
  120.                       more than one space between date and time.
  121.  
  122.    13-Aug-97 V1.3   - Optimization wasn't enabled in SCOPTIONS file
  123.                       (so one dead assignment and ond one possibly
  124.                       uninitialized variable was detected when
  125.                       compiled with optimization)
  126.                     - Recompiled with SAS-C V6.58... Thanks to all the
  127.                       guys who still offer their spare time for
  128.                       bugfixing and improving SAS-C
  129.                     - CLI parameter "ONCE" added
  130.                     - File list contained wrong name of documentation
  131.                       (as always ;-))
  132.  
  133.  
  134. ============================= Archive contents =============================
  135.  
  136. Original  Packed Ratio    Date     Time    Name
  137. -------- ------- ----- --------- --------  -------------
  138.     6036    3387 43.8% 16-Aug-97 18:21:38  ClockChk
  139.     7978    2692 66.2% 16-Aug-97 18:21:42  ClockChk.c
  140.     5309    2316 56.3% 16-Aug-97 18:39:26  ClockChk13.readme
  141.      388     208 46.3% 16-Aug-97 18:34:48  FILE_ID.DIZ
  142.      205     143 30.2% 16-Aug-97 18:21:56  SCOPTIONS
  143. -------- ------- ----- --------- --------
  144.    19916    8746 56.0% 18-Aug-97 00:25:52   5 files
  145.